home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / musicali / splib52d.lha / superplay-lib_DEV / Programmers / autodocs / SuperPlay_Ref_GER.doc < prev    next >
Text File  |  1996-11-15  |  19KB  |  730 lines
  1.  
  2. TABLE OF CONTENTS
  3.  
  4. superplay.library/--background--
  5. superplay.library/SPL_AllocHandle
  6. superplay.library/SPL_FreeHandle
  7. superplay.library/SPL_StopReplay
  8. superplay.library/SPL_FreeResources
  9. superplay.library/SPL_SuperPlay
  10. superplay.library/SPL_SuperWrite
  11. superplay.library/SPL_InitHandleAsDOS
  12. superplay.library/SPL_InitHandleAsClip
  13. superplay.library/SPL_SetWriteType
  14. superplay.library/SPL_GetErrorString
  15. superplay.library/SPL_SetWriteName
  16. superplay.library/SPL_FileInfoRequest
  17. superplay.library/SPL_SetReqIOWindow
  18. superplay.library/SPL_ReadPlayData
  19. superplay.library/SPL_ContinueReplay
  20. superplay.library/SPL_FastForward
  21. superplay.library/SPL_FastBackward
  22. superplay.library/SPL_GetSampleList
  23. superplay.library/SPL_SetSampleList
  24. superplay.library/SPL_GetFileType
  25.  
  26.  superplay.library/--background--              superplay.library/--background--
  27.  
  28.    VERSION
  29.         $VER: SuperPlay_Ref_GER.doc V5.1 (8.8.96)
  30.  
  31.    COPYRIGHT
  32.         © 1994-96 by Andreas R. Kleinert. All rights reserved.
  33.  
  34.         - Feel free to translate this Doc-File into other languages. -
  35.  
  36.    GENERAL
  37.               Andreas R. Kleinert,
  38.               Sandstrasse 1,
  39.               D-57072 Siegen,
  40.               Germany.
  41.  
  42.         EMail:  Fido             Andreas Kleinert 2:2457/350.18
  43.                 Usenet/InterNet  Andreas_Kleinert@superview.ftn.sub.org
  44.  
  45.           If nothing else works, try one of these Fido-InterNet gateways:
  46.  
  47.                 Andreas_Kleinert@p10.f435.n2457.z2.fido.sub.org (in Germany)
  48.                 Andreas_Kleinert@p10.f435.n2457.z2.fidonet.org  (USA or other)
  49.  
  50.    HISTORY
  51.                             V2     bug-fixed ClipBoard-Support
  52.                                    with the supplied SPObjects (ak)
  53.                             V3     created working combination of
  54.                                    SPL_SetSampleList() and SuperWrite()
  55.                                    calls (ak)
  56.                             V4     filetype recognition without loading (ak)
  57.                             V4.6   Autodoc format
  58.                                    SetWriteName: Correct type of write_name
  59.                                    Change two SVL_ prefix to SPL_
  60.                                    Add version behind NAME            (indy)
  61.                             V5.1   SetWriteName parameter must be UBYTE * (ak)
  62.  
  63.  superplay.library/SPL_AllocHandle           superplay.library/SPL_AllocHandle
  64.  
  65.    NAME
  66.         SPL_AllocHandle -- Handle reservieren  (V1)
  67.  
  68.    SYNOPSIS
  69.  
  70.         APTR SPL_AllocHandle(APTR future)
  71.         D0   -$1e            A1
  72.  
  73.    FUNCTION
  74.  
  75.         Reserviert einen Handle zum Zugriff auf ein Sample/Module über
  76.         SPObjects.
  77.  
  78.    INPUT(S)
  79.  
  80.         future - derzeit immer NULL
  81.  
  82.    RESULT
  83.  
  84.         Ein Zeiger auf einen neu reservierten Handle oder NULL, falls
  85.         die Reservierung fehlschlägt.
  86.  
  87.    WARNING
  88.  
  89.         Überprüfe, ob das Ergebnis NULL oder ungleich NULL ist!
  90.  
  91.    SEE ALSO
  92.  
  93.         SPL_FreeResources, SPL_FreeHandle
  94.  
  95.  superplay.library/SPL_FreeHandle             superplay.library/SPL_FreeHandle
  96.  
  97.    NAME
  98.         SPL_FreeHandle -- Handle freigeben (V1)
  99.  
  100.    SYNOPSIS
  101.  
  102.         VOID SPL_FreeHandle(APTR handle)
  103.         D0   -$24           A1
  104.  
  105.    FUNCTION
  106.  
  107.        Beendet das Abspielen und gibt alle Ressourcen sowie den zuvor mit
  108.        SPL_AllocHandle reservierten Handle frei.
  109.  
  110.    INPUT(S)
  111.  
  112.         handle - ein gültiger Handle
  113.  
  114.    RESULT
  115.  
  116.         -
  117.  
  118.    SEE ALSO
  119.  
  120.         SPL_AllocHandle, SPL_StopReplay, SPL_FreeResources
  121.  
  122.  superplay.library/SPL_StopReplay             superplay.library/SPL_StopReplay
  123.  
  124.    NAME
  125.         SPL_StopReplay -- Beendet Abspielen des Samples/Modules  (V1)
  126.  
  127.    SYNOPSIS
  128.  
  129.         VOID SPL_StopReplay(APTR handle)
  130.         D0   -$2a           A1
  131.  
  132.    FUNCTION
  133.  
  134.         Beendet das Abspielen des mit den Handle angegebenen Sample/Module.
  135.         Einige SPObjects ermöglichen es das Sample/Module durch Aufruf
  136.         von SPL_ContinueReplay weiter abspielen zu lassen, nachdem es
  137.         mit SPL_StopReplay gestoppt worden ist.
  138.  
  139.    INPUT(S)
  140.  
  141.         handle - ein gültiger Handle
  142.  
  143.    RESULT
  144.  
  145.         -
  146.  
  147.    SEE ALSO
  148.  
  149.         SPL_ContinueReplay, SPL_FreeResources, SPL_FreeHandle
  150.  
  151.  superplay.library/SPL_FreeResources       superplay.library/SPL_FreeResources
  152.  
  153.    NAME
  154.         SPL_FreeResources -- Freigabe nicht benötigter Ressourcen  (V1)
  155.  
  156.    SYNOPSIS
  157.  
  158.         VOID SPL_FreeResources(APTR handle)
  159.         D0   -$30              A1
  160.  
  161.    FUNCTION
  162.  
  163.         Gibt alle Ressourcen - des mit den Handle angegebenen Samples/Modules
  164.         frei - die nicht benötigt werden, um es einfach nur abzuspielen.
  165.         Das Abspielen des Samples/Modules wird weder gestoppt noch
  166.         unterbrochen.
  167.  
  168.    INPUT(S)
  169.  
  170.         handle - ein gültiger Handle
  171.  
  172.    RESULT
  173.  
  174.         -
  175.  
  176.    SEE ALSO
  177.  
  178.         SPL_AllocHandle, SPL_StopReplay, SPL_FreeHandle
  179.  
  180.  superplay.library/SPL_SuperPlay               superplay.library/SPL_SuperPlay
  181.  
  182.    NAME
  183.         SPL_SuperPlay -- Lädt und spielt Sample/Module (V1)
  184.  
  185.    SYNOPSIS
  186.  
  187.         ULONG SPL_SuperPlay(APTR handle, char *filename)
  188.         D0    -$36          A1           A2
  189.  
  190.    FUNCTION
  191.  
  192.         Lädt und spielt das mit den Dateinamen spezifizierte Sample/Module
  193.         ab.
  194.         Das Handle wird initialisiert und das passende SPObject geöffnet
  195.         und zum Abspielen des Sample/Module verwendet.
  196.  
  197.         Das Abspielen kann entweder durch vollständige Freigabe des
  198.         Handles(SPL_FreeHandle()) beendet oder mit SPL_StopReplay
  199.         unterbrochen werden.
  200.  
  201.    INPUT(S)
  202.  
  203.         handle   - ein gültiger Handle
  204.         filename - ein gültiger AmigaDOS Dateipfad und -name
  205.  
  206.    RESULT
  207.  
  208.         NULL oder eine SPERR-Fehlernummer.
  209.  
  210.    SEE ALSO
  211.  
  212.         SPL_AllocHandle, SPL_StopReplay, SPL_ContinueReplay,
  213.         SPL_FastForward, SPL_FastBackward, SPL_FreeHandle
  214.  
  215.  superplay.library/SPL_SuperWrite             superplay.library/SPL_SuperWrite
  216.  
  217.    NAME
  218.         SPL_SuperWrite -- Sample/Module speichern (V1)
  219.  
  220.    SYNOPSIS
  221.  
  222.         ULONG SPL_SuperWrite(APTR handle, APTR source_handle)
  223.         D0    -$3c           A1           A2
  224.  
  225.    FUNCTION
  226.  
  227.         Normalerweise wird ein Sample/Module mit SPL_SuperPlay geladen
  228.         und abgespielt: Abgesehen von SPL_AllocHandle()/SP_FreeHandle() sind
  229.         hierzu sind keine weiteren Funktionsaufrufe zum Lesen und
  230.         Abpielen der Daten nötig.
  231.  
  232.         Zum Schreiben - also der Konvertierung eines Samples/Modules -
  233.         müssen folgende Funktionsaufrufe ausgeführt werden:
  234.  
  235.         source_handle = SPL_AllocHandle(N);
  236.         result        = SPL_ReadPlayData(source_handle, source_name);
  237.         dest_handle   = SPL_AllocHandle(N);
  238.         /* result     = SPL_InitHandleAsDOS(dest_handle, N); */ /* default */
  239.         result        = SPL_SetWriteName(dest_handle, dest_name, N);
  240.         result        = SPL_SetWriteType(dest_handle, dest_type, N);
  241.         result        = SPL_SuperWrite(dest_handle, source_handle);
  242.         SPL_FreeHandle(dest_handle);
  243.         SPL_FreeHandle(source_handle);
  244.  
  245.  
  246.         Wichtig: Überprüfe den "result" Wert NACH JEDEM Funktionsaufruf
  247.                  (siehe Beispiel Quellcodes) !
  248.  
  249.         Alle möglichen Werte für dest_type können in der SPOBject-List
  250.         der SuperPlayBase gefunden werden.
  251.         Diese Werte VERÄNDERN sich bei jeder Neuinitialisierung der
  252.         superplay.library, deshalb muß man sie bei jeden Öffnen der
  253.         Library erneut auslesen.
  254.  
  255.         WENN "source_handle" = NULL,
  256.         wird überprüft, ob eine SampeList mittels "SPL_SetSampleList()"
  257.         gesetzt worden ist wenn dies der Fall ist wird diese
  258.         SampleList komplett abgespeichert.
  259.  
  260.         Ein wird empfohlen den alten Weg zur Konvertierung zwischen
  261.         Dateiformaten und den neuen Weg zum Abspeichern einzelner(selbst
  262.         erstellter) SampleLists zu verwenden.
  263.  
  264.    INPUT(S)
  265.  
  266.         handle        - ein gültiger Handle          (zum Schreiben)
  267.         source_handle - ein anderer gültiger Handle  (zum Lesen)
  268.  
  269.    RESULT
  270.  
  271.         NULL oder eine SPERR-Fehlernummer.
  272.  
  273.    SEE ALSO
  274.  
  275.         SPL_AllocHandle, SPL_ReadPlayData, SPL_FreeHandle
  276.  
  277.  superplay.library/SPL_InitHandleAsDOS   superplay.library/SPL_InitHandleAsDOS
  278.  
  279.    NAME
  280.         SPL_InitHandleAsDOS -- Initialisiert Handle für AmigaDOS  (V1)
  281.  
  282.    SYNOPSIS
  283.  
  284.         ULONG SPL_InitHandleAsDOS(APTR handle, APTR future)
  285.         D0    -$42                A1           A2
  286.  
  287.    FUNCTION
  288.  
  289.         Initialisiert den Handle für den Zugriff über AmigaDOS hierbei
  290.         wird der angegebene Dateiname benutzt.
  291.  
  292.         Eine andere Möglichkeit besteht darin den Handle für den
  293.         Clipboard Zugriff zu initialisieren(abhängig vom jeweiligen
  294.         SPObject, z.B. IFF-8SVX).
  295.  
  296.    INPUT(S)
  297.  
  298.         handle - ein gültiger Handle
  299.         future - derzeit immer NULL
  300.  
  301.    RESULT
  302.  
  303.         NULL oder eine SPERR-Fehlernummer.
  304.  
  305.    SEE ALSO
  306.  
  307.         SPL_InitHandleAsClip
  308.  
  309.  superplay.library/SPL_InitHandleAsClip superplay.library/SPL_InitHandleAsClip
  310.  
  311.    NAME
  312.         SPL_InitHandleAsClip -- Initialisiert Handle für ClipBoard  (V1)
  313.  
  314.    SYNOPSIS
  315.  
  316.         ULONG SPL_InitHandleAsClip(APTR handle, APTR future)
  317.         D0    -$48                 A1           A2
  318.  
  319.    FUNCTION
  320.  
  321.         Initialisiert einen Handle für den Zugriff aufs Clipboard, dabei
  322.         wird ein (möglicherweise) angegebener AmigaDOS Datename ignoriert.
  323.  
  324.         Die beinahe fast immer benutze Möglichkeit besteht in der
  325.         Initialisierung des Handle zum AmigaDOS Zugriff(wird von
  326.         allen SPObjects unterstützt).
  327.  
  328.    INPUT(S)
  329.  
  330.         handle - ein gültiger Handle
  331.         future - derzeit immer NULL
  332.  
  333.    RESULT
  334.  
  335.         NULL oder ein SPERR-Fehlercode.
  336.  
  337.    SEE ALSO
  338.  
  339.         SPL_InitHandleAsDOS
  340.  
  341.  superplay.library/SPL_SetWriteType         superplay.library/SPL_SetWriteType
  342.  
  343.    NAME
  344.         SPL_SetWriteType -- Schreibtyp setzen  (V1)
  345.  
  346.    SYNOPSIS
  347.  
  348.         ULONG SPL_SetWriteType(APTR handle, ULONG write_type, APTR future)
  349.         D0    -$4e             A1           A2                A3
  350.  
  351.    FUNCTION
  352.  
  353.         Setzt den Schreibtyp für einen SPL_SuperWrite() Aufruf.
  354.         Siehe dortige Beschreibung und Beispiel Quellcodes für weitere
  355.         und detailliertere Informationen.
  356.  
  357.    INPUT(S)
  358.  
  359.         handle     - ein gültiger Handle
  360.         write_type - ein gültiger - zeitlich begrenzter - write_type Code
  361.                      aus der SPObject List
  362.         future     - derzeit immer NULL
  363.  
  364.    RESULT
  365.  
  366.         NULL oder eine SPERR-Fehlernummer.
  367.  
  368.    SEE ALSO
  369.  
  370.         SPL_SuperWrite
  371.  
  372.  superplay.library/SPL_GetErrorString     superplay.library/SPL_GetErrorString
  373.  
  374.    NAME
  375.         SPL_GetErrorString -- Liefert Fehlertext  (V1)
  376.  
  377.    SYNOPSIS
  378.  
  379.         char * SPL_GetErrorString(ULONG error_code)
  380.         D0    -$54                A1
  381.  
  382.    FUNCTION
  383.  
  384.         Liefert den Fehlertext für eine bestimmte Fehlernummer die
  385.         von einer der superplay.library Funktionen zurückgegeben worden
  386.         ist.
  387.  
  388.    INPUT(S)
  389.  
  390.         error_code - eine SPERR-Fehlernummer
  391.  
  392.    RESULT
  393.  
  394.         Nur-Lese Zeiger auf einen SPERR-Fehlertext
  395.  
  396.    SEE ALSO
  397.  
  398.         -
  399.  
  400.  superplay.library/SPL_SetWriteName         superplay.library/SPL_SetWriteName
  401.  
  402.    NAME
  403.         SPL_SetWriteName -- Dateinamen für SPL_SuperWrite() setzen  (V1)
  404.  
  405.    SYNOPSIS
  406.  
  407.         ULONG SPL_SetWriteNameClip(APTR handle, UBYTE *write_name, APTR future)
  408.         D0    -$5a                 A1           A2                 A3
  409.  
  410.    FUNCTION
  411.  
  412.         Setzt den Dateinamen für einen SPL_SuperWrite() Aufruf.
  413.         Siehe dortige Beschreibung und Beispiel Quellcodes für weitere
  414.         und detailliertere Informationen.
  415.  
  416.    INPUT(S)
  417.  
  418.         handle     - ein gültiger Handle
  419.         write_name - ein gültiger AmigaDOS Dateipfad und -name
  420.         future     - derzeit immer NULL
  421.  
  422.  
  423.    RESULT
  424.  
  425.         NULL oder eine SPERR-Fehlernummer.
  426.  
  427.    SEE ALSO
  428.  
  429.         SPL_SuperWrite
  430.  
  431.  superplay.library/SPL_FileInfoRequest   superplay.library/SPL_FileInfoRequest
  432.  
  433.    NAME
  434.         SPL_FileInfoRequest -- Zeigt Informationen zum Sample/Module  (V1)
  435.  
  436.    SYNOPSIS
  437.  
  438.         ULONG SPL_FileInfoRequest(APTR handle, struct Window *window,
  439.         D0    -$60                A1           A2
  440.  
  441.                                   APTR future)
  442.                                   A3
  443.  
  444.    FUNCTION
  445.  
  446.         Gibt ein Infofenster mit mehr oder weniger detaillierten Informationen
  447.         über das derzeit geladene Sample/Module aus.
  448.         Es ist möglich einen Zeiger auf ein Fenster anzugeben mit dem
  449.         spezifiziert wird wo dieses Infofenster erscheinen soll.
  450.  
  451.    INPUT(S)
  452.  
  453.         handle - ein gültiger Handle
  454.         window - ein gültiger Fensterzeiger oder NULL
  455.         future - derzeit immer NULL
  456.  
  457.  
  458.    RESULT
  459.  
  460.         NULL oder eine SPERR-Fehlernummer.
  461.  
  462.    SEE ALSO
  463.  
  464.         SPL_SetReqIOWindow
  465.  
  466.  superplay.library/SPL_SetReqIOWindow     superplay.library/SPL_SetReqIOWindow
  467.  
  468.    NAME
  469.         SPL_SetReqIOWindow -- Default Fenster für Dialogfenster setzen  (V1)
  470.  
  471.    SYNOPSIS
  472.  
  473.         ULONG SPL_SetReqIOWindow(APTR handle, struct Window *window)
  474.         D0    -$66               A1           A2
  475.  
  476.    FUNCTION
  477.  
  478.         Setzt ein Default-Fenster (default: IntuitionBase->FirstWindow)
  479.         für alle Dialogfenster.
  480.  
  481.    INPUT(S)
  482.  
  483.         handle - ein gültiger Handle
  484.         window - ein gültiger Fensterzeiger oder NULL
  485.  
  486.    RESULT
  487.  
  488.         NULL oder eine SPERR-Fehlernummer.
  489.  
  490.    SEE ALSO
  491.  
  492.         SPL_FileInfoReq
  493.  
  494.  superplay.library/SPL_ReadPlayData         superplay.library/SPL_ReadPlayData
  495.  
  496.    NAME
  497.         SPL_ReadPlayData -- Lädt Daten eines Samples/Modules  (V1)
  498.  
  499.    SYNOPSIS
  500.  
  501.         ULONG SPL_ReadPlayData(APTR handle, char *filename)
  502.         D0    -$6c             A1           A2
  503.  
  504.    FUNCTION
  505.  
  506.         Lädt die Daten eines mittels des Dateinamen spezifizierten
  507.         Samples/Modules aber spielt diese NICHT ab.
  508.         Das Handle wird initialisiert und das entsprechende SPObject
  509.         geöffnet, um mit SPL_SuperWrite auf die Sample/Module Daten
  510.         zugreifen zu können.
  511.  
  512.    INPUT(S)
  513.  
  514.         handle   - ein gültiger Handle
  515.         filename - ein gültiger AmigaDOS Dateipfad und -name
  516.  
  517.    RESULT
  518.  
  519.         NULL oder eine SPERR-Fehlernummer.
  520.  
  521.    SEE ALSO
  522.  
  523.         SPL_SetWriteName, SPL_SetWriteType, SPL_SuperWrite
  524.  
  525.  superplay.library/SPL_ContinueReplay     superplay.library/SPL_ContinueReplay
  526.  
  527.    NAME
  528.         SPL_ContinueReplay -- Abspielen fortsetzen  (V1)
  529.  
  530.    SYNOPSIS
  531.  
  532.         ULONG SPL_ContinueReplay(APTR handle)
  533.         D0    -$72               A1
  534.  
  535.    FUNCTION
  536.  
  537.         Einige SPObjects bieten die Möglichkeit das durch SPL_StopReplay
  538.         unterbrochene Abspielen des Samples/Modules durch Aufruf
  539.         dieser Funktion fortzuführen.
  540.  
  541.    INPUT(S)
  542.  
  543.         handle - ein gültiger Handle
  544.  
  545.    RESULT
  546.  
  547.         NULL oder eine SPERR-Fehlernummer.
  548.  
  549.    SEE ALSO
  550.  
  551.         SPL_SuperPlay, SPL_StopReplay
  552.  
  553.  superplay.library/SPL_FastForward           superplay.library/SPL_FastForward
  554.  
  555.    NAME
  556.         SPL_FastForward -- Schnellvorlauf  (V1)
  557.  
  558.    SYNOPSIS
  559.  
  560.         ULONG SPL_FastForward(APTR handle)
  561.         D0    -$78            A1
  562.  
  563.    FUNCTION
  564.  
  565.         Einige SPObjects unterstützen die auch von Kassettenrecordern
  566.         bekannte Möglichkeit des Schnellvor- bzw. rücklaufs durch
  567.         ein Sample/Module.
  568.  
  569.    INPUT(S)
  570.  
  571.         handle - ein gültiger Handle
  572.  
  573.    RESULT
  574.  
  575.         NULL oder eine SPERR-Fehlernummer.
  576.  
  577.    SEE ALSO
  578.  
  579.         SPL_FastBackward
  580.  
  581.  superplay.library/SPL_FastBackward         superplay.library/SPL_FastBackward
  582.  
  583.    NAME
  584.         SPL_FastBackward -- Schnellrücklauf  (V1)
  585.  
  586.    SYNOPSIS
  587.  
  588.         ULONG SPL_FastBackward(APTR handle)
  589.         D0    -$7e            A1
  590.  
  591.    FUNCTION
  592.  
  593.         Einige SPObjects unterstützen die auch von Kassettenrecordern
  594.         bekannte Möglichkeit des Schnellvor- bzw. rücklaufs durch
  595.         ein Sample/Module.
  596.  
  597.    INPUT(S)
  598.  
  599.         handle - ein gültiger Handle
  600.  
  601.    RESULT
  602.  
  603.         NULL oder eine SPERR-Fehlernummer.
  604.  
  605.    SEE ALSO
  606.  
  607.         SPL_FastForward
  608.  
  609.  superplay.library/SPL_GetSampleList       superplay.library/SPL_GetSampleList
  610.  
  611.    NAME
  612.         SPL_GetSampleList -- Zugriff auf SampleList  (V2)
  613.  
  614.    SYNOPSIS
  615.  
  616.         ULONG SPL_GetSampleList(APTR handle, struct SPO_SampleList **list)
  617.         D0    -$84              A1           A2
  618.  
  619.    FUNCTION
  620.  
  621.         Während bzw. nachdem Laden einer Sample-Datei erstellen SPObjects
  622.         der Version 2 eventuell eine spezielle Liste aller Samples die in
  623.         dieser Datei enthalten sind.
  624.         Dies wird in der Regel bei einer Sample-Datei ein Sample sein
  625.         und eine ganze Reihe von Samples bei einen Module.
  626.  
  627.         Nicht alle SPObjects, speziell nicht alle ModuleType-SPObjects,
  628.         unterstützen dies und werden in diesen Fall eine Fehlernummer oder
  629.         eine leere SampleList als Ergebnis liefern.
  630.  
  631.    INPUT(S)
  632.  
  633.         handle - ein gültiger Handle
  634.         list   - ein Zeiger auf einen SPO_SampleList Zeiger
  635.  
  636.    RESULT
  637.  
  638.         NULL oder eine SPERR-Fehlernummer.
  639.  
  640.    SEE ALSO
  641.  
  642.         SPL_SetSampleList
  643.  
  644.  superplay.library/SPL_SetSampleList       superplay.library/SPL_SetSampleList
  645.  
  646.    NAME
  647.         SPL_SetSampleList -- SampleList setzen  (V2)
  648.  
  649.    SYNOPSIS
  650.  
  651.         ULONG SPL_SetSampleList(APTR handle, struct SPO_SampleList *list)
  652.         D0    -$8a              A1           A2
  653.  
  654.    FUNCTION
  655.  
  656.         Zum Speichern von Sample-Dateien mit SPObjects der Version 2 kann
  657.         eine spezielle Liste aller Samples, die in dieser Datei erscheinen
  658.         sollen, verwendet werden.
  659.  
  660.         Dies wird in der Regel bei einer Sample-Datei ein Sample sein
  661.         und eine ganze Reihe von Samples bei einen Module.
  662.  
  663.         Nicht alle SPObjects, speziell nicht alle ModuleType-SPObjects,
  664.         unterstützen dies und könnten stattdessen ein
  665.         SPERR_ACTION_NOT_SUPPORTED als Fehler liefern.
  666.  
  667.    INPUT(S)
  668.  
  669.         handle - ein gültiger Handle
  670.         list   - ein Zeiger auf eine SPO_SampleList
  671.  
  672.    RESULT
  673.  
  674.         NULL oder eine SPERR-Fehlernummer.
  675.  
  676.    SEE ALSO
  677.  
  678.         SPL_GetSampleList
  679.  
  680.  superplay.library/SPL_GetFileType           superplay.library/SPL_GetFileType
  681.  
  682.    NAME
  683.         SPL_GetFileType -- Liefert Dateitypen-Code  (V4)
  684.  
  685.    SYNOPSIS
  686.  
  687.         ULONG SPL_GetFileType(APTR handle, char *filename, ULONG *filetype)
  688.         D0    -$90            A1           A2              A3
  689.  
  690.    FUNCTION
  691.  
  692.         Findet den SuperPlay spezifischen Dateitypen-Code
  693.         (der bei jeder (neuen)-Initialisierung der Library neu definiert
  694.         wird) oder SP_FILE_TYPE_UNKNOWN (== NULL == FALSE).
  695.  
  696.         Benutzen Sie folgende Funktionsaufrufe für eine einfache Überprüfung:
  697.  
  698.         handle   = SPL_AllocHandle(N);
  699.         SPerr    = SPL_GetFileType(handle, filename, &filetype);
  700.                    SPL_FreeHandle(handle);
  701.  
  702.         Dieser Handle darf NICHT für weitere Operationen mit dieser
  703.         Datei benutzt werden(Datei wird einmal geöffnet und zweimal
  704.         überprüft aber nur einmal geschlossen, usw.)
  705.  
  706.         Initialisierungs Funktionen wie SPL_InitHandleAsClip() sind
  707.         gar nicht erlaubt.
  708.  
  709.         Wichtig, diese Funktion setzt nur die FILETYPES und nicht
  710.         die SUBTYPES. Zum Schreiben müssen sie z.B. diese SUBTYPES
  711.         spezifizieren.
  712.  
  713.         FILETYPES sind nur für eine einfache Idendifikation gedacht
  714.         und geben nur den allgemeinen Typ an(8SVX, ST).
  715.  
  716.    INPUT(S)
  717.  
  718.         handle   - ein gültiger Handle
  719.         filename - ein gültiger AmigaDOS Dateipfad- und -name
  720.         filetype - Zeiger auf ULONG für SP_FILETYPE-Wert
  721.  
  722.    RESULT
  723.  
  724.         NULL oder eine SPERR-Fehlernummer.
  725.  
  726.    SEE ALSO
  727.  
  728.         SPL_AllocHandle(), SPL_FreeHandle()
  729.  
  730.